LEADTOOLS Medical (Leadtools.Dicom assembly)

SetStringValue(DicomElement,String[]) Method

Show in webframe







An item in the Data Set.
Character string that contains the string value(s) to set. If you want to set multiple values in the Value Field, put all string values in this array.
Sets the string value(s) of a Data Element.
Syntax
public bool SetStringValue( 
   DicomElement element,
   string[] value
)
'Declaration
 
Public Overloads Function SetStringValue( _
   ByVal element As DicomElement, _
   ByVal value() As String _
) As Boolean
'Usage
 
Dim instance As DicomDataSet
Dim element As DicomElement
Dim value() As String
Dim value As Boolean
 
value = instance.SetStringValue(element, value)
public bool SetStringValue( 
   DicomElement element,
   string[] value
)

            
public boolean setStringValues(DicomElement element, String[] value)
 function Leadtools.Dicom.DicomDataSet.SetStringValue(DicomElement,String[])( 
   element ,
   value 
)
public:
bool SetStringValue( 
   DicomElement^ element,
   array<String^>^ value
) 

Parameters

element
An item in the Data Set.
value
Character string that contains the string value(s) to set. If you want to set multiple values in the Value Field, put all string values in this array.

Return Value

true if the string value(s) were set successfully. false if could not set the string value(s) of the Data Element.
Remarks

This overload of SetStringValue(DicomElement,String[],DicomCharacterSetType) differs from other versions (SetStringValue(DicomElement,String[])) in that it is missing the last argument (DicomCharacterSetType). This overload is affected by the value(s) in the Specific Character Set (0008,0005) Attribute.

The following DICOM Value Representations are affected by Attribute Specific Character Set (0008,0005)

If element is one of these Value Representations and the string cannot be represented using the standard character set (ASCII characters), then this overload attempts to encode the string using one or character sets stored in the Specific Character Set Attribute (0008,0005). Before calling this method with unicode strings, make sure that the Specific Character Set Attribute of the DicomDataSet contains values for any character set that is necessary. For example, when encoding a japanese string the the following are some of the possible values for specific character: For more information, see Part 3 section 'C.12.1.1.2 Specific Character Set' of the DICOM Specification. If more than one value is stored in the Value Field of the Data Element, you must set all values at the same time.

This method can be called only if the Value Representation of the Data Element is:

For more information about Value Representations, refer to Default Value Representation Table.
Example
For an example, refer to SetStringValue(DicomElement,String,DicomCharacterSetType)
Requirements

Target Platforms

See Also

Reference

DicomDataSet Class
DicomDataSet Members
Overload List
SetValue Method
SetStringValue(DicomElement,String,DicomCharacterSetType) Method
SetStringValue(DicomElement,String[],DicomCharacterSetType) Method
SetStringValue(DicomElement,String) Method
SetStringValue(DicomElement,String[]) Method
SetStringValuePtr(DicomElement,IntPtr,Int32) Method
SetStringValuePtr(DicomElement,IntPtr,UInt32,DicomCharacterSetType) Method
SetBinaryValue(DicomElement,Byte[],Int32) Method
SetShortValue(DicomElement,Int16[],Int32) Method
SetIntValue(DicomElement,Int32[],Int32) Method
SetFloatValue(DicomElement,Single[],Int32) Method
SetDoubleValue(DicomElement,Double[],Int32) Method
SetAgeValue Method
SetDateValue(DicomElement,DicomDateValue[]) Method
SetTimeValue(DicomElement,DicomTimeValue[]) Method
SetDateTimeValue(DicomElement,DicomDateTimeValue[]) Method
SetConvertValue(DicomElement,String,Int32) Method

 

 


Products | Support | Contact Us | Copyright Notices
© 2006-2014 All Rights Reserved. LEAD Technologies, Inc.

Leadtools.Dicom requires a Medical toolkit server license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features